<?php
use yii\helpers\Html;
$actionId = Yii::$app->controller->action->id;
?>
<?= Html::beginTag('div', ['class' => 'col-lg-3', 'style' => 'overflow:auto']) ?>

<?= Html::tag('h3', 'CSS、JS和数据的调用说明') ?>
<?= Html::beginTag('div', ['class' => 'form-group']) ?>

<?php if ($actionId=='catalog-create' || $actionId=='catalog-update'){?>
    <?= Html::label('获取栏目内容：写在php代码里') ?>
<pre>$catalog['字段名'];
如：名称：$catalog['name']
    别名：$catalog['alias']
    摘要：$catalog['intro']
图文信息：$article['字段名']
    标题：$article['title']
    作者：$article['author']
    摘要：$article['intro']
    封面：$article['face']
    内容：$article['content']
    组图：$article['photos']
列表：
    ListView::widget([
        'dataProvider' => $dataProvider,
        'itemView' => $itemView,
    ])
备注：栏目类型为图文时才会有图文信息
    组图有值时，值为以'|'连接的字符串，如
    if($article['photos']){
        foreach(explode('|',$article['photos']) as $photo){
            Html::img($photo);
        }
    }
    栏目类型为目录时才会有列表信息
    列表内容在目录列表块编辑
    默认带分页，分页大小默认为20
    具体参数见
    http://www.yiichina.com/doc/api/2.0/yii-widgets-listview
</pre>
<?php }elseif($actionId=='post-create' || $actionId=='post-update'){?>
    <?= Html::label('获取内容和相关信息：写在php代码里') ?>
<pre>$post['字段名'];
如：标题：$post['title']
    作者：$post['author']
    摘要：$post['intro']
    封面：$post['face']
    组图：$post['photos']
    内容：$post['content']
    发布时间：date("Y-m-d H:i:s",$post['created_at'])
目录信息：$catalog['字段名'];
    名称：$catalog['name']
    别名：$catalog['alias']
    摘要：$catalog['intro']
上一条信息：$prev['字段名'];
    ID：$prev['id']
    标题：$prev['title']
下一条信息：$next['字段名'];
    ID：$next['id']
    标题：$next['title']
内容属性信息：$attributes['属性名称']
    如：$attributes['原价']

备注：组图有值时，值为以'|'连接的字符串，如
    if($post['photos']){
        foreach(explode('|',$post['photos']) as $photo){
            Html::img($photo);
        }
    }
</pre>
<?php }?>

<?= Html::label('一、引用CSS（已默认引用site.css）') ?>
<ul>
    <li>1、引入CSS文件：在php代码里加入下面代码
        <pre>$this->registerCssFile("css路径（相对|绝对）", ['depends' => [BootstrapAsset::className()]]);</pre>
    </li>
    <li>2、编写CSS：在php代码里加入下面代码
<pre>$this->registerCss("CSS代码（不能出现英文“”）");
如：$this->registerCss("body { background: #f00; }");
</pre>
    </li>
    <li>3、head加标签（不限于CSS）
<pre>
&lt;?php $this->beginBlock('head'); ?&gt;
    这里写head要加的标签
&lt;?php $this->endBlock('head'); ?&gt;
备注：标签会加载到&lt;/head&gt;前，对于母版页无效
</pre>
    </li>
</ul>
<?= Html::endTag('div') ?>

<?= Html::beginTag('div', ['class' => 'form-group']) ?>
<?= Html::label('二、注册JS脚本（已默认引用jquery.js）') ?>
<ul>
    <li>1、引入JS文件：在php代码里加入下面代码
        <pre>$this->registerJsFile('js路径（相对|绝对）', ['depends' => [JqueryAsset::className()]]);</pre>
    </li>
    <li>2、编写JS：在php代码里加入下面代码
<pre>$script = &lt;&lt;&lt;JS
    这里写JS脚本
JS;
$this->registerJs($script);
备注：JS脚本会自动加载到jQuery(document).ready(function () {});
</pre>
    </li>
    <li>3、编写JS
<pre>
&lt;?php $this->beginBlock('js'); ?&gt;
    &lt;script type="text/javascript"&gt;
        这里写JS脚本
    &lt;/script&gt;
&lt;?php $this->endBlock('js'); ?&gt;
备注：JS脚本会加载到&lt;/body&gt;前，对于母版页无效
</pre>
    </li>
</ul>
<?= Html::label('三、内部链接') ?>
<ul>
    <li>1、目录链接</li>
<pre>Url::to(['/catalog', 'alias' => '栏目别名'])
如：&lt;a href="&lt;?=Url::to(['/catalog', 'alias' => '栏目别名'])?&gt;"&gt;栏目&lt;/a&gt;
</pre>
    <li>2、内容链接</li>
<pre>Url::to(['/post', 'id' => 内容id])
如：&lt;a href="&lt;?=Url::to(['/post', 'id' => 内容id])?&gt;"&gt;内容&lt;/a&gt;
</pre>
</ul>
<?= Html::label('四、调用基本设置') ?>
<ul>
    <?php $i = 1;
    foreach ((array)$configs as $cnf) {
        if ($cnf['scode'] == 'base') { ?>
            <li><?= $i ?>、<?= $cnf['name'] ?>：&lt;?=$conf['<?= $cnf['variable'] ?>']?&gt;</li>
            <?php $i++;
        }
    } ?>
</ul>
<?= Html::label('五、调用自定义设置') ?>
<ul>
    <?php $i = 1;
    foreach ((array)$configs as $cnf) {
        if ($cnf['scode'] == 'custom') { ?>
            <li><?= $i ?>、<?= $cnf['name'] ?>：&lt;?=$conf['<?= $cnf['variable'] ?>']?&gt;</li>
            <?php $i++;
        }
    } ?>
</ul>

<?= Html::label('六、获取前台主导航') ?>
<ul>
    <li>1、只获取一级：写在php代码里</li>
<pre>$navItems = Catalog::getNavItems();
使用：
    $navItems = Catalog::getNavItems();
    foreach($navItems as $nav){
        echo Html::a($nav['name'],Url::to(['/catalog', 'alias' => $nav['alias']]));
    }
</pre>
    <li>2、获取一级和二级：写在php代码里</li>
<pre>$navItems = Catalog::getNavItems(2);
使用：
    $navItems = Catalog::getNavItems(2);
    foreach($navItems as $nav){
        echo Html::a($nav['name'],Url::to(['/catalog', 'alias' => $nav['alias']]));
        echo '&lt;ul&gt;';
        foreach((array)$nav['childItems'] as $child){
            echo '&lt;li&gt;'.Html::a($child['name'],Url::to(['/catalog', 'alias' => $child['alias']])).'&lt;/li&gt;';
        }
        echo '&lt;/ul&gt;';
    }
</pre>
</ul>

<?= Html::label('七、获取幻灯片：写在php代码里') ?>
<pre>$photos = Banner::photos('幻灯片名称');
使用：
    $photos = Banner::photos();
    foreach($photos as $photo){
        echo Html::a(Html::img($photo['src']),$photo['url']);
    }
</pre>

<?= Html::label('八、调用自定义模块') ?>
<ul>
    <?php $i = 1;
    foreach ((array)$modules as $mdu) { ?>
        <li><?= $i ?>、<?= $mdu['name'] ?>：&lt;?=$mdu['<?= $mdu['name'] ?>']?&gt;</li>
        <?php $i++;
    } ?>
</ul>

<?= Html::label('九、获取内容项：写在php代码里') ?>
<pre>$postItems = Post::items('栏目别名',数量,推荐);
使用：
    $postItems = Post::items('news');
    echo '&lt;ul&gt;';
    foreach($postItems as $post){
        echo '&lt;li&gt;';
        echo Html::a($post['title'],$post['url']);
        echo '&lt;/li&gt;';
    }
    echo '&lt;/ul&gt;';
说明：$post字段有：id,title,author,intro,face
    其中：author为作者，intro为摘要，face为封面src
    数量默认为6，推荐默认为非（推荐=true或1时为推荐）
内容属性信息：$post['attributes']['属性名称']
    如：$post['attributes']['原价']
</pre>

<?= Html::label('十、获取友情链接：写在php代码里') ?>
<pre>$linkItems = Links::items('图片|文字');
使用：
    $linkItems = Links::items('文字');
    echo '&lt;ul&gt;';
    foreach($linkItems as $link){
        echo '&lt;li&gt;';
        echo Html::a($link['name'],$link['url']);
        echo '&lt;/li&gt;';
    }
    echo '&lt;/ul&gt;';
说明：$link字段有：name,url,attach
    其中：name为名称，url为链接，attach为图片src
</pre>

<?= Html::label('十一、通过JS提交留言内容') ?>
<pre>在页面上插入以下JS或把以下JS写到单独的js文件再引用
$("#提交按钮的id").click(function () {
    var title = $("#标题id").val();//标签为input
    var telephone = $("#手机id").val();//标签为input
    var email = $("#邮箱id").val();//标签为input
    var content = $("#内容id").val();//标签为textarea
    var csrf = $('meta[name="csrf-token"]').attr("content");//记得到带上
    $.post("/message/save.html", {
        "Message[title]": title,
        "Message[telephone]": telephone,
        "Message[email]": email,
        "Message[content]": content,
        _csrf: csrf
    }, function (result) {
        console.log(result);
        if (result.success == true) {
            window.location.reload();//刷新，也可以做跳转
        } else {
            alert(result.errors);
        }
    }, "json");
});
</pre>

<label>备注：php代码为： &lt;?php ?&gt;</label>
<pre>
输出内容时需要在要输出的内容前加上“echo”或“=”
如：&lt;?php echo $model['字段名']; ?&gt;
或：&lt;?= $model['字段名'] ?&gt;
</pre>

<?= Html::endTag('div') ?>
<?= Html::endTag('div') ?>
<?php
$script = <<<JS
    $(".col-lg-3").height($(".col-lg-9").height());
JS;
$this->registerJs($script);
?>
